home *** CD-ROM | disk | FTP | other *** search
/ Softwarová Záchrana 3 / Softwarova-zachrana-3.bin / BLAT for Windows / blat222.full.zip / BLAT222 / docs / syntax.txt < prev   
Text File  |  2003-12-13  |  8KB  |  147 lines
  1. Blat v2.2.1 (build : Dec 10 2003 18:22:28)
  2.  
  3.  
  4. Win32 console utility to send mail via SMTP or post to usenet via NNTP
  5. by P.Mendes,M.Neal,G.Vollant,T.Charron,T.Musson,H.Pesonen,A.Donchey,C.Hyde
  6.   http://www.blat.net
  7. syntax:
  8.   Blat <filename> -to <recipient> [optional switches (see below)]
  9.   Blat -install <server addr> <sender's addr> [<try>[<port>[<profile>]]] [-q]
  10.   Blat -profile [-delete | "<default>"] [profile1] [profileN] [-q]
  11.   Blat -h
  12.  
  13. -------------------------------- Installation ---------------------------------
  14. -install[SMTP|NNTP|POP3] <server addr> <sender's email addr> [<try n times>
  15.      [<port> [<profile> [<username> [<password>]]]]]
  16.      : set server, sender, number of tries and port for profile
  17.        (<try n times> and <port> may be replaced by '-')
  18.        port defaults are SMTP=25, NNTP=119, POP3=110
  19.        default profile can be specified with a '-'
  20.        username and/or password may be stored to the registry
  21.        order of options is specific
  22.        use -installNNTP for storing NNTP information
  23.        use -installPOP3 for storing POP3 information
  24.            (sender and try are ignored, use '-' in place of these)
  25.  
  26. --------------------------------- The Basics ----------------------------------
  27. <filename>      : file with the message body ('-' for console input, ^Z ends)
  28. -of <file>      : text file containing more options (also -optionfile)
  29. -to <recipient> : recipient list (also -t) (comma separated)
  30. -tf <file>      : recipient list filename
  31. -cc <recipient> : carbon copy recipient list (also -c) (comma separated)
  32. -cf <file>      : cc recipient list filename
  33. -bcc <recipient>: blind carbon copy recipient list (also -b)
  34.                   (comma separated)
  35. -bf <file>      : bcc recipient list filename
  36. -maxNames <x>   : send to groups of <x> number of recipients
  37. -subject <subj> : subject line, surround with quotes to include spaces(also -s)
  38. -ss             : suppress subject line if not defined
  39. -sf <file>      : file containing subject line
  40. -body <text>    : message body, surround with quotes to include spaces
  41. -sig <file>     : text file containing your email signature
  42. -tag <file>     : text file containing taglines, to be randomly chosen
  43. -ps <file>      : final message text, possibly for unsubscribe instructions
  44.  
  45. ----------------------------- Registry overrides ------------------------------
  46. -p <profile>    : send with server, user, and port defined in <profile>
  47.                 : use username and password if defined in <profile>
  48. -profile        : list all profiles in the Registry
  49. -server <addr>  : specify SMTP server to be used (optionally, addr:port)
  50. -serverSMTP <addr>
  51.                 : same as -server
  52. -serverNNTP <addr>
  53.                 : specify NNTP server to be used (optionally, addr:port)
  54. -serverPOP3 <addr>
  55.                 : specify POP3 server to be used (optionally, addr:port)
  56.                 :   used when POP3 access is required before sending email
  57. -f <sender>     : override the default sender address (must be known to server)
  58. -i <addr>       : a 'From:' address, not necessarily known to the server
  59. -port <port>    : port to be used on the SMTP server, defaults to SMTP (25)
  60. -portSMTP <port>: same as -port
  61. -portNNTP <port>: port to be used on the NNTP server, defaults to NNTP (119)
  62. -portPOP3 <port>: port to be used on the POP3 server, defaults to POP3 (119)
  63. -u <username>   : username for AUTH LOGIN (use with -pw)
  64. -pw <password>  : password for AUTH LOGIN (use with -u)
  65. -pu <username>  : username for POP3 LOGIN (use with -ppw)
  66. -ppw <password> : password for POP3 LOGIN (use with -pu)
  67.  
  68. ---------------------- Miscellaneous RFC header switches ----------------------
  69. -organization <organization>
  70.                 : Organization field (also -o and -org)
  71. -ua             : include User-Agent header line instead of X-Mailer
  72. -x <X-Header: detail>
  73.                 : custom 'X-' header.  eg: -x "X-INFO: Blat is Great!"
  74. -noh            : prevent X-Mailer/User-Agent header from showing Blat homepage
  75. -noh2           : prevent X-Mailer header entirely
  76. -d              : request disposition notification
  77. -r              : request return receipt
  78. -charset <cs>   : user defined charset.  The default is ISO-8859-1
  79. -a1 <header>    : add custom header line at the end of the regular headers
  80. -a2 <header>    : same as -a1, for a second custom header line
  81. -dsn <nsfd>     : use Delivery Status Notifications (RFC 3461)
  82.                 : n = never, s = successful, f = failure, d = delayed
  83.                 : can be used together, however N takes precedence
  84. -hdrencb        : use base64 for encoding headers, if necessary
  85. -hdrencq        : use quoted-printable for encoding headers, if necessary
  86. -priority <pr>  : set message priority 0 for low, 1 for high
  87.  
  88. ----------------------- Attachment and encoding options -----------------------
  89. -attach <file>  : attach binary file(s) to message (comma separated)
  90. -attacht <file> : attach text file(s) to message (comma separated)
  91. -embed <file>   : embed file(s) in HTML.  Object tag in HTML must specify
  92.                   content-id using cid: tag.  eg: <img src="cid:image.jpg">
  93. -base64         : send binary files using base64 (binary MIME)
  94. -uuencode       : send binary files UUEncoded
  95. -enriched       : send an enriched text message (Content-Type=text/enriched)
  96. -html           : send an HTML message (Content-Type=text/html)
  97. -alttext <text> : plain text for use as alternate text
  98. -alttextf <file>: plain text file for use as alternate text
  99. -mime           : MIME Quoted-Printable Content-Transfer-Encoding
  100. -8bitmime       : ask for 8bit data support when sending MIME
  101. -multipart <size>
  102.                 : send multipart messages, breaking attachments on <size>
  103.                   KB boundaries, where <size> is per 1000 bytes
  104.  
  105. ---------------------------- NNTP specific options ----------------------------
  106. -groups <usenet groups>
  107.                 : list of newsgroups (comma separated)
  108.  
  109. -------------------------------- Other options --------------------------------
  110. -h              : displays this help
  111. -q              : suppresses *all* output
  112. -debug          : echoes server communications to screen
  113. -log <file>     : log everything but usage to <file>    
  114. -timestamp      : when -log is used, a timestamp is added to each log line
  115. -ti <n>         : set timeout to 'n' seconds.  Blat will wait 'n' seconds for
  116.                   server responses
  117. -try <n times>  : how many times blat should try to send (1 to 'INFINITE')
  118. -binary         : do not convert ASCII | (pipe, 0x7c) to CrLf in the message
  119.                   body
  120. -hostname <hst> : select the hostname used to send the message via SMTP
  121.                   this is typically your local machine name
  122. -raw            : do not add CR/LF after headers
  123. -delay <x>      : wait x seconds between messages being sent when used with
  124.                   -maxnames or -multipart
  125. -comment <char> : use this character to mark the start of commments in
  126.                   options files and recipient list files
  127. -superdebug     : hex/ascii dump the data between Blat and the server
  128. -superdebugT    : ascii dump the data between Blat and the server
  129. -------------------------------------------------------------------------------
  130.  
  131. Note that if the '-i' option is used, <sender> is included in 'Reply-to:'
  132. and 'Sender:' fields in the header of the message.
  133.  
  134. Optionally, the following options can be used instead of the -f and -i
  135. options:
  136.  
  137. -mailfrom <addr>   The RFC 821 MAIL From: statement
  138. -from <addr>       The RFC 822 From: statement
  139. -replyto <addr>    The RFC 822 Reply-To: statement
  140. -returnpath <addr> The RFC 822 Return-Path: statement
  141. -sender <addr>     The RFC 822 Sender: statement
  142.  
  143. For backward consistency, the -f and -i options have precedence over these
  144. RFC 822 defined options.  If both -f and -i options are omitted then the
  145. RFC 821 MAIL FROM statement will be defaulted to use the installation-defined
  146. default sender address.
  147.